QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

Managing Interpolation Styles

QuickDraw 3D provides routines that you can use to manage interpolation styles.

Q3InterpolationStyle_New

You can use the Q3InterpolationStyle_New function to create a new interpolation style object.

TQ3StyleObject Q3InterpolationStyle_New (
                     TQ3InterpolationStyle interpolationStyle);
interpolationStyle
An interpolation style value.

DESCRIPTION

The Q3InterpolationStyle_New function returns, as its function result, a new style object having the interpolation style specified by the interpolationStyle parameter. The interpolationStyle parameter should be one of these values:

kQ3InterpolationStyleNone
kQ3InterpolationStyleVertex
kQ3InterpolationStylePixel

If a new style object could not be created, Q3InterpolationStyle_New returns the value NULL .

To change the current interpolation style, you must actually draw the style object. You can call Q3Style_Submit to draw the style in retained mode or Q3InterpolationStyle_Submit (described next) to draw the style in immediate mode.

SEE ALSO

See "Interpolation Styles" for a description of the available interpolation styles.

Q3InterpolationStyle_Submit

You can use the Q3InterpolationStyle_Submit function to submit an interpolation style in immediate mode.

TQ3Status Q3InterpolationStyle_Submit (
                     TQ3InterpolationStyle interpolationStyle,
                     TQ3ViewObject view);
interpolationStyle
An interpolation style value.
view
A view.

DESCRIPTION

The Q3InterpolationStyle_Submit function sets the interpolation style of the view specified by the view parameter to the style specified in the interpolationStyle parameter.

SPECIAL CONSIDERATIONS

You should call Q3InterpolationStyle_Submit only in a submitting loop.

Q3InterpolationStyle_Get

You can use the Q3InterpolationStyle_Get function to get the interpolation style value of an interpolation style.

TQ3Status Q3InterpolationStyle_Get (
                     TQ3StyleObject interpolationObject,
                     TQ3InterpolationStyle *interpolationStyle);
interpolationObject
An interpolation style object.
interpolationStyle
On exit, a pointer to the interpolation style value of the specified interpolation style object.

DESCRIPTION

The Q3InterpolationStyle_Get function returns, in the interpolationStyle parameter, a pointer to the current interpolation style value of the interpolation style object specified by the interpolationObject parameter.

Q3InterpolationStyle_Set

You can use the Q3InterpolationStyle_Set function to set the interpolation style value of an interpolation style.

TQ3Status Q3InterpolationStyle_Set (
                     TQ3StyleObject interpolationObject,
                     TQ3InterpolationStyle interpolationStyle);
interpolationObject
An interpolation style object.
interpolationStyle
An interpolation style value.

DESCRIPTION

The Q3InterpolationStyle_Set function sets the interpolation style value of the style object specified by the interpolationObject parameter to the value specified in the interpolationStyle parameter.


© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |